<!DOCTYPE HTML PUBLIC "-//ORA//DTD CD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>[Chapter 24] 24.22 java.io.FileWriter (JDK 1.1)</TITLE>
<META NAME="author" CONTENT="David Flanagan">
<META NAME="date" CONTENT="Thu Jul 31 16:22:07 1997">
<META NAME="form" CONTENT="html">
<META NAME="metadata" CONTENT="dublincore.0.1">
<META NAME="objecttype" CONTENT="book part">
<META NAME="otheragent" CONTENT="gmat dbtohtml">
<META NAME="publisher" CONTENT="O'Reilly &amp; Associates, Inc.">
<META NAME="source" CONTENT="SGML">
<META NAME="subject" CONTENT="Java">
<META NAME="title" CONTENT="Java in a Nutshell">
<META HTTP-EQUIV="Content-Script-Type" CONTENT="text/javascript">
</HEAD>
<body vlink="#551a8b" alink="#ff0000" text="#000000" bgcolor="#FFFFFF" link="#0000ee">

<DIV CLASS=htmlnav>
<H1><a href='index.htm'><IMG SRC="gifs/smbanner.gif"
     ALT="Java in a Nutshell" border=0></a></H1>
<table width=515 border=0 cellpadding=0 cellspacing=0>
<tr>
<td width=172 align=left valign=top><A HREF="ch24_21.htm"><IMG SRC="gifs/txtpreva.gif" ALT="Previous" border=0></A></td>
<td width=171 align=center valign=top><B><FONT FACE="ARIEL,HELVETICA,HELV,SANSERIF" SIZE="-1">Chapter 24<br>The java.io Package</FONT></B></TD>
<td width=172 align=right valign=top><A HREF="ch24_23.htm"><IMG SRC="gifs/txtnexta.gif" ALT="Next" border=0></A></td>
</tr>
</table>

&nbsp;
<hr align=left width=515>
</DIV>
<DIV CLASS=sect1>
<h2 CLASS=sect1><A CLASS="TITLE" NAME="JNUT2-CH-24-SECT-22">24.22 java.io.FileWriter (JDK 1.1)</A></h2>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-24-SECT-22.1"></A></h3>
</DIV>

<P CLASS=para>
<tt CLASS=literal>FileWriter</tt> is a convenience subclass of
<tt CLASS=literal>OutputStreamWriter</tt> that is useful when you want to
write text (as opposed to binary data) to a file.  You
create a <tt CLASS=literal>FileWriter</tt> by specifying the file to be
written to, and optionally specifying whether the data
should be appended to the end of an existing file instead of
overwriting that file.

<P CLASS=para>
The <tt CLASS=literal>FileWriter</tt> class creates an internal
<tt CLASS=literal>FileOutputStream</tt> to write bytes to the specified
file, and uses the functionality of its superclass,
<tt CLASS=literal>OutputStreamWriter</tt>, to convert the Unicode characters
written to the stream characters into bytes using the
default encoding of the default locale.  (If you want to use
an encoding other than the default, you cannot use
<tt CLASS=literal>FileWriter</tt>; in that case you must create your own
<tt CLASS=literal>OutputStreamWriter</tt> and <tt CLASS=literal>FileOutputStream</tt>.)

<P CLASS=para>
Because <tt CLASS=literal>FileWriter</tt> is a trivial subclass of
<tt CLASS=literal>OutputStreamWriter</tt>, it does not define any methods
of its own, but simply inherits them from its superclass.

<DIV CLASS=screen>
<P>
<PRE>
public class <tt CLASS=literal>FileWriter</tt> extends OutputStreamWriter {
    // <tt CLASS=literal>Public Constructors</tt>
            public <tt CLASS=literal>FileWriter</tt>(String <tt CLASS=literal>fileName</tt>) throws IOException;
            public <tt CLASS=literal>FileWriter</tt>(String <tt CLASS=literal>fileName</tt>, boolean <tt CLASS=literal>append</tt>) throws IOException;
            public <tt CLASS=literal>FileWriter</tt>(File <tt CLASS=literal>file</tt>) throws IOException;
            public <tt CLASS=literal>FileWriter</tt>(FileDescriptor <tt CLASS=literal>fd</tt>);
}
</PRE>
</DIV>

</DIV>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-24-SECT-22.2">Hierarchy:</A></h3>

<P CLASS=para>
Object->Writer->OutputStreamWriter->FileWriter

</DIV>

</DIV>


<DIV CLASS=htmlnav>

<P>
<HR align=left width=515>
<table width=515 border=0 cellpadding=0 cellspacing=0>
<tr>
<td width=172 align=left valign=top><A HREF="ch24_21.htm"><IMG SRC="gifs/txtpreva.gif" ALT="Previous" border=0></A></td>
<td width=171 align=center valign=top><a href="index.htm"><img src='gifs/txthome.gif' border=0 alt='Home'></a></td>
<td width=172 align=right valign=top><A HREF="ch24_23.htm"><IMG SRC="gifs/txtnexta.gif" ALT="Next" border=0></A></td>
</tr>
<tr>
<td width=172 align=left valign=top>java.io.FileReader (JDK 1.1)</td>
<td width=171 align=center valign=top><a href="index/idx_0.htm"><img src='gifs/index.gif' alt='Book Index' border=0></a></td>
<td width=172 align=right valign=top>java.io.FilenameFilter (JDK 1.0)</td>
</tr>
</table>
<hr align=left width=515>

<IMG SRC="gifs/smnavbar.gif" USEMAP="#map" BORDER=0> 
<MAP NAME="map"> 
<AREA SHAPE=RECT COORDS="0,0,108,15" HREF="../javanut/index.htm"
alt="Java in a Nutshell"> 
<AREA SHAPE=RECT COORDS="109,0,200,15" HREF="../langref/index.htm" 
alt="Java Language Reference"> 
<AREA SHAPE=RECT COORDS="203,0,290,15" HREF="../awt/index.htm" 
alt="Java AWT"> 
<AREA SHAPE=RECT COORDS="291,0,419,15" HREF="../fclass/index.htm" 
alt="Java Fundamental Classes"> 
<AREA SHAPE=RECT COORDS="421,0,514,15" HREF="../exp/index.htm" 
alt="Exploring Java"> 
</MAP>
</DIV>

</BODY>
</HTML>
